|
|
Log Analyzer is an auxiliary application for HostMonitor,
it is included into Advanced Host Monitor package. Professional and Enterprise licenses for Advanced Host Monitor
already include a license for Log Analyzer. Holders of a Lite or Standard licenses may buy an additional
license for Log Analyzer separately. |
Intro
Menu
Full screen chart
Report Manager
Options
Scripts
System Requirements
Price
As you know HostMonitor is able to log test results into a log file.
Log Analyzer is a graphical tool that visualizes the log data.
It parses the contents of a log file and presents the data as a variety of charts representing different test statistics.
Log Analyzer may analyze all types of log files: HTML, Text, and DBF log files.
In a second, administrator can get a snap shot of the host performance over a period of days or even months.
Several examples of the reports:
Example #1
Example #2
Example #3
Features:
- Log Analyzer allows you to check information individually for each test;
- It allows to analyze several log files at once;
- For each test you can view a graphical chart;
- The highly flexible Report Manager allows you to create and customize reports to your taste in a variety of ways;
- Scripting support allows you to create reports automatically.
Main menu:
File |
Load | - | Loads and analyzes specified log file |
Append | - | Appends information from specified log file into the current data set |
Refresh | - | Rereads all loaded log files |
Print | - | Prints information from an active pane |
Exit | - | Closes Log Analyzer |
|
Search |
Find | - | Searches for specific text, and highlights the first occurrence |
Search again | - | Repeats the last search (starts from current position) |
Filter | - | Date filter allows you to analyze log file(s) for specified period of time |
|
View |
Toolbar | - | Shows/hides toolbar |
Log pane | - | Shows/hides log pane |
Chart pane | - | Shows/hides chart pane |
|
Chart |
Full screen | - | Displays full screen version of a chart |
Copy image to Clipboard | - | Copies a chart as an image into the clipboard |
Print | - | Brings up a Print Preview dialog that allows you to print a chart |
|
Reports |
<list of the reports> | - | Generates HTML report using selected report profile |
Report Manager | - | Brings up Report Manager dialog allowing you to modify and create new report profiles |
|
Options |
Interface | - | Displays Options dialog with interface related settings |
Chart | - | Displays Options dialog allowing you to modify settings of the the full screen chart |
Reports | - | Displays Options dialog with the settings related to the reports |
|
Help |
Help | - | Displays Help |
Home page | - | Starts default web browser, opens home page of the Log Analyzer on www.ks-soft.net |
WWW Forum | - | Starts default web browser, opens web forum on www.ks-soft.net |
Support | - | Allows you to send e-mail to our tech support staff |
About | - | About Log analyzer |
License | - | License information and registration options |
Full screen chart:
To display a chart in a full screen window, choose the item "Full screen chart" from
the popup menu (this menu appears when you right-click in the Log Analyzer
window).
Starting from version 3.50 Log Analyzer allows zooming in and out over the selected area of a chart.
To zoom in on a chart area, hold the left mouse button and drag mouse
down and right. You will see a rectangle around the selected area. Release
the left mouse button to zoom in. You may continue zooming again and again.
To restore (undo) the zoom, drag a rectangle in the opposite direction (up and left).
After you right click the chart you may change upper and lower limits of the vertical and horizontal axis
using "Set bounds" popup menu item. In the Chart Bounds dialog use an "Interval to display"
parameter to set what time period needs to be displayed on the graph (horizontal axis).
Use "Bounds to display" parameter to set the limits for "Reply" value mapping onto a graph (vertical axis).
Test logged time (from-till) | - | shows the whole period of time for which records in the log are available |
Interval to display (from-till) | - | specifies the period of time to display on the screen |
Test "Reply" value (min-max) | - | minimum and maximum values of the "Reply" field in the log file |
Bounds to display (from-till) | - | specifies the lower and upper limits of the vertical axis.
The user may change them to display the "Reply" values with a different scale. |
There are following commands available in the chart's popup menu:
3D | - | enable/disable 3D effects |
Statistics | - | show/hide semi-transparent panel with statistical information about the test |
Options | - | brings up Options dialog |
Set bounds | - | brings up Chart Bounds dialog (allows you to set lower and upper limits both for vertical and horizontal axis) |
Adjust | - | sets the lower and upper limit of a vertical axis so that the "Reply" values of the selected time interval are fit on the screen |
Copy image to Clipboard | - | copies a chart as an image into the clipboard |
Save to file | - | saves an image of the chart as a bitmap (BMP) file |
Print | - | brings up Print Preview dialog |
Close | - | closes full screen chart (returns to Log Analyzer main window) |
To close the full screen chart and return to Log Analyzer main window, press [ESC] or [Enter] or select
"Close" menu item after the right click on the chart.
Report Manager:
The highly flexible Report Manager allows you to create and customize reports in a variety of ways.
Within each profile you may set the following parameters:
Filter
Display following fields
The listbox on the left in the Report Manager dialog window contains the list of fields that you may include into
the report (e. g., test name, test method, average reply, downtime, etc.). Click on the check box next to a field name
to mark/unmark the item. Use "Mark all" button to select all available fields, use "Unmark all" button to deselect
all items, use "Invert selection" to invert selection for the list.
Include following tests
The list in middle selects the test types to include into the report (e. g., all tests except Ping and CPU Usage tests).
Click on the check box next to a field name to mark/unmark the item. Use "Mark all" button to select all available
fields or use "Clear all" button to deselect all items. "Invert selection" option is also available.
Skip following tests
Use the listbox on the right to exclude some specific tests from the report.
Chart
Chart settings
Log Analyzer can create chart for each test. Choose one of the following options and specify width & height of the images.
Do not create charts
Create charts, add links to the report
Create charts, insert images into the report
Charts are stored as an images in GIF file format.
File
File
By default Log Analyzer saves all reports into one directory (you can specify that directory in the Options dialog),
and uses the name of the profile as a file name (with HTM extension).
But you can specify another file name by choosing the "Put report into particular file" option and providing a
path and name of the file.
Overwrite prompt
With this option enabled Log Analyzer will ask for confirmation if the report file that is going to be created already exists.
Resolve macros
If you enable this option a date macro variables may be specified in the destination file name.
Log Analyzer will interpret text between the '%' in the file name as a macro variable, where 'DD' represents the
day of the month, 'MM' - the month, 'YY' - the year (2 last digits), 'YYYY' - the year.
This allows creating file names by a template such as one of these:
C:\HostMonitor4\Reports\%DDMMYY%-rep.htm
C:\HostMonitor4\Reports\%YYYY\DD-MM%.htm
Templates
Use external header
Use external footer
Using these options you can provide an HTML files that will be used as a header and/or footer for the report.
Mark this option only if you want to change the standard header or footer of the report. In HostMonitor's
directory "Examples\LAReports\" you can find an example of the header and footer (the files: footer1.htm, header1.htm).
In the header/footer file you can use macro variables to show the current date and time. You may select different colors and so on.
Below is a list of the macro variables that may be used in an external header/footer:
Variable | Description |
%Date% | current date |
%Time% | current time |
%DateTime% | current date & time |
%BGColor% | background color |
%TextColor% | text color |
%LinkColor% | hypertext link color |
%VLinkColor% | visited link color |
%ALinkColor% | active link color |
Use template for the table
By using this option you may provide a file with HTML code that will be used to represent each test within the report.
Of course each test has unique parameters so you have to use macro variables (which represent different test parameters) in the template.
For example: if you want to create the report that will display a table with an average reply value for each test,
use simple template with 2 variables:
"<tr><td>%TestName%</td><td>%AverageReply%</td></tr>"
(an HTML code for the header of a table should be contained in the header file).
In HostMonitor's directory "Examples\LAReports\" you will find an example of such template (file templ1.htm).
Below is a list of the macro variables that can be used in a template:
Variable | Description |
%TestName% | name of the test |
%TestMethod% | test method |
%Period% | represents the whole time interval of the test log |
%AverageReply% | the average value of the results obtained |
%MinReply% | the minimum value of the results obtained |
%MaxReply% | the maximum value of the results obtained |
%AliveRatio% | Percentage of "Good" test results |
%DeadRatio% | Percentage of "Bad" test results |
%UnknownRatio% | Percentage of "Unknown" test results |
%DetailedLogFile% |
when this variable occurs in the table template, Log Analyzer creates HTML file that contains all check results
for the test. It substitutes this variable with a corresponding file name.
So, if you want to provide detailed log file for each test, use HTML code such as "<a href="%detailedlogfile%">".
|
%ImageFile% | when this variable occurs in a template Log Analyzer creates
GIF image that represents the test results and inserts the file name of this image file instead of the variable.
So, if you want to insert images into the report, use HTML code like "<img src="%imagefile%">".
If you want to insert links to images into the report, use code like "<a href="%imagefile%">".
|
Several examples of the reports:
Example #1
Example #2
Example #3
Create reports
Report Manager dialog contains several buttons that allow you to generate reports right away:
Current profile: creates report using current profile (the one you are currently editing)
Selected profiles: creates reports for marked profiles
All profiles: creates reports for all profiles
Options:

Interface page
Colors
Offers a choice of colors for the text, background and a chart pane.
Show Toolbar
Shows/hides the toolbar
Show Log pane
Shows/hides the log pane
Show Chart
Shows/hides the chart pane
Grid
By using this option you may specify a number of vertical and horizontal lines of the grid in a chart pane.
You may also enable or disable grid in the log pane.
Use fixed date&time format
By default Log Analyzer gets current Windows regional settings at startup and uses these parameters until you change
Windows settings and restart application. You may use this option to define the date & time formats (e.g. DD/MM/YYYY
h:mm:ss AMPM). In this case, Log Analyzer will use the specified formats overriding the system settings.
BTW: Changing the date format does not affects analyzing of the DBF and HTML log files. Log Analyzer is able to
analyze these log files correctly regardless of the date & time settings. However this option can be useful to analyze
text log files or html log files that were created by older versions of HostMonitor.
Chart page
You may chose the color scheme for the full screen chart on this page.
Reports page
Default destination folder
Provide a path to the default destination folder for the reports. If this parameter is empty, Log Analyzer will use
the directory where it was started from. In Report Manager you may specify different
destination directory for some of the reports.
Folder for images & detailed logs
Here you may specify a path to a separate folder where auxiliary images and detailed log files will be stored.
If you specify the relative path, Log Analyzer will use "Default destination folder"+"Folder for images"
as a destination path. E.g. if you have defined "C:\HostMonitor4\Reports\" as a default folder and "Images\"
as folder for images, then images and detailed logs will be stored in "C:\HostMonitor4\Reports\Images\" directory.
Use macros
If you enable this option a date macro variables may be specified in the path.
Log Analyzer will interpret the text between the '%' of the path string as a macro, where 'DD' represents the
day of the month, 'MM' - the month, 'YY' - the year (2 last digits), 'YYYY' - the year.
For example the use of such a template will create a separate folder every day:
C:\HostMonitor4\Reports\%DD-MM-YY%\
C:\HostMonitor4\Reports\%YYYY\DD-MM%\
Color palette
You may customize color scheme for the HTML reports. The following elements have customizable colors
(you may change both fore- and background colors):
underlaying layer;
table header;
test items;
system messages;
HTML links;
Visited HTML links;
Active HTML links;
To change the color of an element, click on an element that you want to change.
Use right-click to change its background color, and left-click to change the text color.
The colors of the chart (GIF images) may be changed on Chart page of the Options dialog.
Scripts:
Log Analyzer 4.0+ supports scripts. Scripts allow you to generate reports automatically by schedule
(e.g. using standard NT scheduler). Log Analyzer Script file (default extension .LAS) is a simple text file
that contains commands for the application. You can create and edit script file using any text editor (e.g. notepad).
Some common rules:
You can put only one command in each line
Comments: The program ignores all strings with a semicolon (;) as the 1st character
Commands: commands are case insensitive (e.g. "Load" and "LOAD" means the same)
When you provide a log file name or a date filter you can use date macro variables.
Log Analyzer will interpret the text between '%' in the parameter as a date macro variable,
where 'DD' represents the day of the month, 'MM' - the month, 'YY' - the year
(2 last digits), 'YYYY' - the year.
List of the commands:
Command | Parameter(s) | Description |
Load | <log file name> | Loads and analyzes specified log file |
Append | <log file name> | Appends information from specified log file into current data set |
Filter | <start date> <end date> | Applies filter that determines what time period Log Analyzer should include into the reports.
Format of the <start date> & <end date> is: DDMMYYYY |
CreateReport | "<report profile name>" | Creates report using specified report profile |
CreateSelectedReports | | Creates reports for marked profiles (those that are marked in the Report Manager dialog) |
CreateAllReports | | Creates reports for all profiles |
Example of the script:
;------------------------------------------
Load C:\HostMonitor4\logs\%YYYY%\log.htm
Append C:\HostMonitor4\logs\privatelog1.htm
Append C:\HostMonitor4\logs\privatelog2.htm
Filter %01MMYYYY% %30MMYYYY%
CreateReport "HTTP tests (charts)"
CreateReport "HTTP tests (no charts)"
Createreport "Template1"
;------------------------------------------
To execute a script, you should start Log Analyzer with the following command line parameter "-script:<name of script file>".
There is also an optional parameter "-log:<name of the log file>". With this optional parameter
Log Analyzer will record information about script execution and about errors in the script (if any) into the
specified file.
Example: LogsMan.exe -script:reports.las -log:scriptlog.txt
Minimum system requirements
- Windows 95 (OSR2), 98, ME, NT 4.0, Windows 2000, or XP
- Internet Explorer 4.0 or higher (application can work without IE but help system will not be available)
- 2 Mb of free disk space
- Minimum screen resolution: 800 x 600
Recommended:
- Internet Explorer 5+
- Screen resolution: 1024 x 768 or higher
How much does it cost?
When you purchase an Advanced Host Monitor PROFFESIONAL or ENTERPRISE edition you will get the license for
Log Analyzer at no cost. Otherwise the license costs $45.
You can order Log Analyzer using credit card, Switch and Solo debit cards, check/money order or wire transfer.
If you are concerned about submitting your order and/or credit card information online, you may register the
Log Analyzer via phone, fax or postal mail.
Details..
|